Mesa is a 3-D graphics library with an API which is very similar to that
of OpenGL*. To the extent that Mesa utilizes the OpenGL command syntax
or state machine, it is being used with authorization from Silicon Graphics,
Inc. However, the author makes no claim that Mesa is in any way a
compatible replacement for OpenGL or associated with Silicon Graphics, Inc.
Those who want a licensed implementation of OpenGL should contact a licensed
vendor. This software is distributed under the terms of the GNU Library
General Public License, see the LICENSE file for details.
* OpenGL(R) is a registered trademark of Silicon Graphics, Inc.
Author
Brian Paul
Avid Technology
6400 EnterPrise Lane, Suite 201
Madison, WI 53719
brianp@elastic.avid.com
Formerly employed at the Space Science and Engineering Center at the
University of Wisconsin - Madison.
Mac-port done by:
Miklós Fazekas
boga@valerie.inf.elte.hu
All questions about the Mac distribution should sent to me. (boga@valerie.elte.hu)
Also see the Mac-Mesa hompage for the lastest version:
http://valerie.inf.elte.hu/~boga/Mesa.html
Installing Mesa for Mac:
•Install the shared libraries:
Place the folder named Mesa3D inside the folder System Extensions: Mesa (debug off): into the System Folder:Extensions Folder. (No restart needed)
If you wan't to use the Debug Libraries, change the glShdLib to the one located in the Debug Extensions. (note that you should always run with a DebugStr capable debugger. like CW Pro debugger.)
Try to compile the program Sample, at Examples:Sample. (Projects for CodeWarrior Pro included) If you have other CodeWarrior/Compiler, make an ANSI C PPC project, and put the
"Mesa 3D Graphics Library:Headers" folder into the Access Paths:System Path. Then put the glShdLib, gluShdLib, glutShdLib, aglShdLib from the Libraries folder into the project. Set the application heap to 4000 Kb, and the stack size to 128 kb. Also include the source named GlutHello.c Then run.
If it doesn't run contact me. (boga@valerie.inf.elte.hu)
Tip: The example folder contains some interesting OpenGL programs.
•Installing GLUT Documentation:
Copy the "glut.qv" file into your QuickView folder (if installed).
Run QuickView, and type "glut" and press return to test the installation.
Mac implementation notes:
Mesa 3D Graphics Library is a shared library for PowerPC™/CFM-68K based computers running MacOS. The Api is in C with support for development using C++. This library was written with CodeWarrior Pro 2, and you can use best with it. Other compilers with CFM support also sould work.
RoadMap to enclosed folders:
Interfaces - This folder contains the headers.
Libraries - This folder contains the link libraries (the shared libraries that you use to link against). You should use the files in this folder to link your application. To write application that use the OpenGL API link against glShdLib,gluShdLib,aglShdLib. To make use of the GLUT toolkit, also link against glutShdLib. To make use of the AUX/TK toolkit also link against the auxShdLib. (Currently avaible for PPC only).
Examples - This folder contains sample code to help you get started developing Mesa/OpenGL applications. (Most of these demos from the GLUT distribution, see the GLUT ReadMe int the ReadMe's/License folder). The RedBook folder contains simple examples, the other examples are more complex.
Documentation - This folder contains the GLUT databases for the Toolbox Assistant, and a text file desribes AGL, the MacOS interface for Mesa/OpenGL.
ReadMe's/License - This folder contains more information about Mesa, GLUT. You should also read the LICENSE and the COPYRIGHT files.
System Extensions:Mesa (debug off) - This folder contains optimized versions of the Mesa aglShdLib,glShdLib,gluShdLib,glutShdLib,auxShdLib, extension file. You should place these files in the Extensions folder inside your System Folder. (No restart needed).
Library Source- This folder contains the source code for the Mesa, AGL interface for Mesa, GLUT for Mac libraries.
New for version 3.0b1(98/03/15):
• Updated for Mesa 3.0b2. (fixes small bugs with texturing)
• RAVE driver is functional again.
• Better blending in RAVE dirver.
• Included more demos. + MacOS demos: PowerPlant+GameSprocket demos.
• Now uses software Mesa if the RAVEMDD is in the System Folder.
• Maximum window width is 1600 and not 800 as in Mesa 3.0dx.
New for version 3.0d3:
• Minor bugs fixed. (glBitmap/glClear/glClearColor)
New for version 3.0d2:
• Uses Mesa 3.0b1 with 1.2 OpenGL api.
• 3.0 version of GLUT. Many code rewritten, near full compliant.
• Faster software driver.
• Fixed a bug which prevent accum based pixel formats.
• Preliminary 3Dfx included.
• More samples.
New for version 3.0d1:
• Preliminary 3Dfx included.
• First Mesa 3.0 compile only the fxMesa worked.
New for version 2.6b1:
• Uses Mesa 2.6b5.
• MouseUp bug fixed in GLUT.
• GLUT shows no resize bug.
• RAVE can be anabled/disabled with a RAVEMDD plugin.
• Added software driver.
• Better agl-library.
New for version 2.6d0:
• Uses Mesa 2.6b1.
• Better glut library.
• Inital RAVE implementation.
• Added support for 16-bit.
• Better glShdLib.dbg
Examples:
• Added demos from 3DFX demos. (Called RAVE Demos).
• Revisted frame buffering scheme (read Mac Notes for details).
• Debug version of the glShdLib.
GLUT Implementation notes:
The GLUT implementation was completly rewritten for Mesa 3. Write me if you have any incompatibilities with GLUT.
My GLUT implementation is based on PowerPlant, and has a nice info window.
An online GLUT-help in QuickView is avaible.
GLUT expects a three-button mouse and to implement this on the Macintosh the modifier keys are used in conjunction with the mouse button. The mappings are:
• by itself ’ Left button
• with<Command> Left button
• with<Option> Middle button
• with<Control> Right button
All modifiers may be used at any time during a single button press.
All of the examples under Examples use the GLUT API.
Performance tips:
• Set the monitor to 32-bit mode.
• Turn off smooth shading when you don't need it (glShadeModel)
• Turn off depth buffering when you don't need it.
• Turn off dithering when not needed.
• Use double buffering as it's often faster than single buffering.
• Try to maximize the amount of drawing done between glBegin/glEnd pairs.
• Use the info window (command-I) in GLUT to find best performance.
• Optimized polygon rasterizers are employed when:
RGB mode, not grayscale, not monochrome
depth buffering is GL_LESS, or disabled
flat or smooth shading
dithered or non-dithered
no other rasterization operations enabled (blending, stencil, etc)
• Optimized line drawing is employed when:
rendering into back buffer which is an XImage
RGB mode, not grayscale, not monochrome
depth buffering is GL_LESS or disabled
flat shading
dithered or non-dithered
no other rasterization operations enabled (blending, stencil, etc)
• Textured polygons are fastest when:
using a 3-component (RGB), 2-D texture
minification and magnification filters are GL_NEAREST
texture coordinate wrap modes for S and T are GL_REPEAT
